iT邦幫忙

第 12 屆 iThome 鐵人賽

DAY 3
0

今天我們終於要來點實作啦,前兩天介紹的心癢癢,今天終於能初窺 Gatsby 的風采 !

開發環境建置與說明

在進行實作之前,我建議大家對以下幾點有個基本的認識

  1. 對 Command Line 有個基礎的認識,例如知道 cd、touch、mkdir 代表的意思為何,如你是 Mac 系統的使用者,可以開啟 Terminal,如果你是 Windows 系統的使用者,可以開啟 PowerShell。
  2. 確保你的環境已經安裝了 Node.js & NPM ( Node Package Manager ),你可以開啟終端機 ( 上述的 Terminal or PowerShell ),並輸入 node —version & npm —version 來確認你的 Node.js & NPM 是否安裝成功。

https://ithelp.ithome.com.tw/upload/images/20200918/20109495UkwNixy3VO.png

輸出的版本號與圖中不符沒關係,但若是沒出現版本號,請確認是否安裝成功。

建立第一個專案

就像 Vue、React 一樣,Gatsby 也有自己的 CLI,藉由著 CLI 我們能快速建立一個包含 Gatsby 的網站,並使用它所提供的指令。

接著我們輸入以下指令來進行安裝

npm install -g gatsby-cli

同樣地,我們可以藉由

gatsby -v 

來確認是否安裝成功。

若成功安裝的看倌們,照過來照過來,這邊我介紹幾個常用的指令

  1. Gatsby new ( 專案名稱 ) ( 欲使用的樣板 Github Repo Url )

ex

gatsby new hello-world https://github.com/gatsbyjs/gatsby-starter-hello-world

當你不帶任何樣板網址時,將會使用官方預設的 gatsby-starter-default

如果你兩個參數都不代入時,Gatsby 也會貼心地一步一步帶領你建立專案

例如下圖

gatsby new
? What is your project called? › my-gatsby-project
? What starter would you like to use? › - Use arrow-keys. Return to submit.
❯  gatsby-starter-default
   gatsby-starter-hello-world
   gatsby-starter-blog
   (Use a different starter)
  1. Gatsby develop

在專案的根目錄上執行此指令,Gatsby 就會在預設的 8000 port 上建立起伺服器囉

  • 如果想要改用其他 Port 號的朋友,可以藉由以下指令來使用自定義的 Port 號
gatsby develop -p 9527

接下來我們就一步一步帶領各位建立出第一個專案吧 !

  1. 藉由輸入 gatsby new hello-world https://github.com/gatsbyjs/gatsby-starter-hello-world 來建立 Project。

https://ithelp.ithome.com.tw/upload/images/20200918/20109495tkyTlwr9iK.png

  1. 若是成功建立,則會出現下圖

https://ithelp.ithome.com.tw/upload/images/20200918/20109495J7F3NRP58L.png

  1. 接著輸入 cd 專案名稱與 gatsby develop 來啟動專案。
  • 若您的 8000 Port 已經被使用,則會出現
    Something is already running at port 8000,
    只要輸入 Y 即可繼續。
  1. 看到下面這一段文字,代表你已經成功建立起開發伺服器囉 !
    是不是非常簡單呢?

https://ithelp.ithome.com.tw/upload/images/20200918/20109495M5Pcn0kDDw.png

  1. 接著在你的瀏覽器中輸入 http://localhost:設定的 Port 號/並看見 Hello world,代表你已經完成囉 !

明天我們會針對專案架構做一個詳細的講解,順便介紹一些 React 基本的知識,來幫助各位能順利地往後閱讀唷

參考資料

Gatsby.js Tutorials


上一篇
[Day 02] - 什麼是 Gatsby ?
下一篇
[Day 04] - 初探 Gatsby 之專案結構說明
系列文
雖然你不是木村拓哉,但它也可以讓你變很行 - Gatsby.js30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言